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1,0 PURPOSE 

the SCRIPT pPooPom allowo opod«toP*lnpd oooyonoos of 
ehaPae*opo to &• iint ° Vir mu I t I p I • ossudo-taiatyops (PTYs) 
*nd thopoby o||ow tho simulation of • lotd on tho 
tUitihiplRg oyotom, Tho pooulto of t pu" em bo wstohod 
en-lTno md ftttlittco of posoonoa tlmo, otc, oon bo 
pocopdod on tho oyotom dTok, 



2,0 JOB CAPABILITY 

Th§ SCRIPT ofoOPtm hat boon written t t t rtontrant Drogue 
tho eodo and toxt to bo oont ipo |n tho h|gh soomont *nd eon 
bo oharod s y povopal Jobo# oaeh with a t* 'o* soomont, Etch 
lob can eontPol uo to 14 Jobs* oo It boeomts ootololo to 
simulate a lorflo numoop of P0P-1P t|pp«ph t p|ng uso'O, 



3,0 CONTROL FEATURES 

Tho SCRIPT It loadod Into tho High sogagnt fPo* any PQP-10 
Tnout dovteo. In addition to tno toxt to bo oont, eontpol 
commando eon b f Tnoludod to dotopmlno tho spood at which tho 
simulated uoon will oooPtto, 



3.1 Timing RaPtmotopi 

Paramotoro igbjoct to vapfstlon fneiudo typo*!n tlmo f 
tyoo«out tlma, and usop "think" t!mo, Tnp type-In md 
type-out time Pan bo opoelMod as a oonst t nt op ao a Ptto, 
Tn which oooo tho time would dooond on tho numbop of 
ehaPaetopo tont op Pooolvod. Tho "think" time |o bpoken up 
Tnto two eaPtoi 1) tho allowed Po'Ponoo tlmo, and 2) "fpoe" 
time. - If tho eomputeP oTvoo Inotontanoogo pooponto to a 
command* tho total dtlay If pimply tho sym of thp two 
guantltiao, if roooonoo lo greater than allowed* "think" 
tlmo lo ooual to tht "fpoe" tlmo, in botwoon. "th|«k" tlmp 
To tha sum of aliowod reooonee Plus "fpse" t|mp mfnyo tho 
actual eonpytop Posoonoo to tho command, one additional 
tlmo factOP aliowod Is tho ability to oot a maxjmym response 
olus tyoe-eut do lav ?6p a glvan command. If tho command 
exeoodo this limit* thon tho Job is IntoPpuptad by ponding 
two contPo|»c ohapactpps ovop tha oooydo teletype. This 
allows a sopfpt to lncludo ppogptw ioqps which spo 
Tntoppuptod a'tep a ooeclflod t|m 9 Intopval, Tho opopatop 
ran multiply thoso dtlay tlmos by on Intogop fpetOPt In 
cartTculaPi thpy oan bo oot tp to debug s ooplot without 
tho dolavo ppooont, 
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3.2 ReeetltTen of SePtota 

An addltlenal ScRIRT language feetupe el lews the SCRIPT to 
specify hew i»eny tlmee It will be oneeutodi to that study 
state loading eendltlong ctn be meaeured, The ootrtter cin 

override t*a repaat count. 



7.3 StgggerTng lead Buildup 

when mul t Id | • Jobs art to follow the SCRIPT, the SCRIPT may 
specify t eteggerfna Intepval ee that lead bullduo can be 

Qpeduti . 



3.4 Multiple Jtef Numbers 

as a* optional Nature, the SCRIPT program will eenvert the 
"** oharaetpp Into a two digit oetai stplnfl equal to the *TY 
unit number, ThTa wT | I allow one seplot to log many jobs In 
under different numpcpe or fop multiple Jobs to use eeeorate 
Hies, ai< etandard scripts use thia feetupe to leg Into 
r4,7?7i3, 



4, « LOGSP'G or results 

The SC*ieT opogpan m§kee an entpy In thg |og fTi§ for eaeh 
line of »T* data eent tp the tlme«ehaplng system, The time* 
Identity of a oaptTeulap Job* numbgp gf ghapaetere sent, 
numbop of ghapacters peoelved, number of buffeps received, 
and total pgsponss tins are all reoepdgd, In addition, 
delays Tn pending op simulating tsiatyps output due to poop 
SCRIPT oppgpem pesppnss ape aiep Pepprded, This* provides 
ssme Idea ef how thp response to the oentpplllng Job 
affeetod systsm load and peseonoe tfmg measure*onte, 
Ideally thg oontPoillnp Job would be pegUtlme, ?,e, high 
o>Toplty and locked fn core, Delays to the eertet 
Tndut/outout ITghtan the pverall eystsm load, while delays 
Tn reooivlftg reoueete fop mope Input are msasupsd as |f ths 
usop Jpo had experienced woree reeppnse than It actually 
did. 

as a further ohoek on errors In reopbnss t|mg measurements 

due to pepp egpfpt opogpam pgeppnssi a n +» ohapaetep Is 

cutout whsn peep SCRIPT program rgspgngp may have eaussd the 

at wake fun tlen In the mpnltpp tp fall, when thle haepene, 

tha SCRIPT program wT I I wake up bassd en Its sleep Interval 
• nd not on object Jpb Poeoongo, Nopmgliy, thg monttop 

resete tha slsso ePunt whsn a Job running sn a 
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4,1 Definition of Reaoonae Tlma 

tha paopensf tlma maaiupad la tha total t|ma fpom outputtlng 
<"tyelng") a I fne ovap tha pty until tha opogpaw Paouaita 
tha next Ifna er tlmaa out to two eontPol*e eharaetepg» laaa 
tlma aoant emulating TTY outout, Thua# If one lint to tha 
syatam ppo^ueet 50 llnea of outout» ona Pptponae t|ma will 
-a paeopdadi which la tha total tlma tha user waa waiting 
fop tha oo^outap, 



4,2 Ovaplao and Ita Effect on Reaoenee Tfma Maaauramanta 
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4,3 Olf^aPant Buffering Modet 



If tha SCRIPT ooaeTfTad output at a function of time, than 
tha SCRI'T opoopam wafta until tha dalay it up, than data la 
tranafepped ovap tha PTY to tha SCRIPT opogram, When tha 
SCRIPT apaeTflaa an output pate, tha eepfpt program wuet 
Mpat raad tha data ?pom tha PTY, datapmlnt tha delay, and 
than alter, Specifying ona moda or th* othap m§y ba 
aoopbpplata to particular oreorama dga to dTffarant 
buffering *odee, 
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4,4 Anaiytta of Reaeonee Time Results 

in any eve^ti tht user must antlyss reeoense tTms results 
with a k"o*itdM of thttt fastors, and a" undspstandlns *f 
the everiao between u sar Dreersm buffepe» menTtep buffsps f 
tnd script buffara. Aitsrnsts|y# If oaye*oieeleal system 
rierformenot Is Important, tha yssr e«n usa tha system 
•nanualiy end saa how olsvarly ths oy stent |s esnesallna Ita 
resoenee, Tha main ouraesa of ths SCRIPT program Ta ta 
obtain consistent raiatlva reepsngs figures ts ssssss tha 
effect of h A pa«apa and eeftwePt ehtnges In tne tlme«shaPlns 
•yatem, 
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5.1 Com*a*d Lints 

a SCRIPT ft |« eenafsts of SCRIPT Unas which and wit* a 
<tTne ftart> ehapaetsr, SCRIPT llnss apa althap commend 
ijnaa or text llnee, Command llnta ara ussd to control 
typing and aaopatlon of tha SCRIPT gpegra". Taiit llnas »pa 
ee«t ovap tha oaeuda talatyaa ta purr tha object Jobe, 

a command line basTna with ana exclamation oafnt which Is 
followed by a non-exelamatlan oalnt character, 



5.2 Text Lines 

a text line begins wTth no aitalamatlan po|nt# sp with two 
•xelamatTon paints, \n this eas*» only the aaeend Is aant 
to the object Job. If a SCRIPT Mno bsslns with ana 
uo-aprowi than the up-arrow la net sa«tl Inatesd ths next 
eharactar la converted to a eontPel ehapsatap by 
eomolamentlna b I t ipg, Two go«arpswe Pesylt l« ana uo»aPP«w 
seine sent, (The CR/LF at tha and of any line staPtlng with 
a single uo-arrow are not aant.) 

Note that "I" one "♦" have no algnlfleanco except at the 
beginning of a text or command lint. 
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5,3 Command line Syntax 

command Ifnee consist of numbers and letter swlteheo, 
swltehee thit take numerical valuta may b§ sreeeeded by a 
number, A number conaJgtg of Doatlbly one minus sign 
loUoMid by a string of dselmal dlol*t. There cm bt no 
soaces of tabs between tht start and and of a number, At 
other points, eoeecs and tabs art Ignored In command lints, 

should a number net bs eeeelfledi tht last number supplied 
Tt eesumsd, If no valus hat bssn tupolltdi a isrs Is 
•ssumsd at tht start of taeh command lint, 

rtrtaln Ittttr switches may net havt numbtrs aotoolatto with 
them, rhitt swttehts may net bt preceded by a numbtr 
unites txtfe '• on Inttrvtnlng lttt§p ewlteh that allows a 
numbtr , 

filteal ohtraetere or bad ayntax rteult |n an error when 
nroctsstng Joba, Thtet trrore art not dstteted when tht 
SCRIPT le loaded Into the high segment, 

a command Hns may Include a comment by utlne a semleolon, 
a double ssmleblon and any charactsrg remaining on thg 
eommand |l«e a's dtitttd "ho* the Script Is loaded a»d so 
use no core at run-time, the first e characters following 
th« first agrcent slon of the double st^lcalon comment of 
the flret SCRIPT line (If any) are tt|«en as the SC R IRT'g 
version number (usually "%nn«">, 

a command lint must not tnd *lth a numbtr, Thus a Isttsr 
switch must follow any number in a command line. 
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9,4 LttttP fwltthtt 



! 



•■mt M T txettt tn§t It tttt ty§t««ut rttt, 
f ntPi»ntottTvt tPtuwtnt tuooMtd 



f ntn»nttttlvt trouwtnt tutoMtd 
f ntfttTvt tftumtnt tuttHtd 



»• ttte tytt»!« 

tftlty 
»• tttt tytt»l« 



f non*ntottTvt arou»tnt tuiaMid 

f non-ntaatTvo tPtu*tnt tuptHtd 

f oetttfvt pPtumtnt tuppMtd 

f t petltfvt tpau*tnt tuttiltd 

f itre treu*t*t tuotlltd 



no tPtwwtntt tl |o*td 

no tp«u*iintt tllo*td 
u nt ftpoumtnti tllowtd 
v nt tptuwtntt tl|o«td 

r If ootltTvt tPtumtnt tuptHtd 
Tf x§po traumtfit tupelltd 

(tool Its fop ntxt lint only) 
x no tpoumontt tllowtd 



»• tttt t| lt»td 
Ptttftt tlmt 

»• tttt tptt tint 

>• tttt tttoctp 

tlmt 

»• tttt nymbtp of 
tTmtt tt dt 
SCHIFT, 

»• tttt maximum 
dtlay btfopt 
pptartm ttndt 
♦ etc 

»• l«h?bftt 
ttndMt ♦c»e 
tTmo«oyt 

»• tttt ! moot 

f to 

»• olttpt ! *odt 
fiat 

•• tttt u moot 

flit 

•• tlttpt u «tdt 
fito 

»• tttt nymbtp of 
txpotttd tppopt 

»• InnTbltt tppop 

ohoekfno 



>•» pttt of i !n§ It 

oommtnt to 

OPtPtttP 
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5,5 TlmTng Unite 

flmtt art In ml M leecande, Retea are M ml I I laeoonoe oar 
character. 

b.6 L Modi 

uhen L mod* Ta aat <CR> and <LF> will net bt itnt ovar the 

pTY, thus a ll"e andTno with <ALTMCDE> ean be aant, Any 

ilno muet end however with a full enactor aat break 

character dui to a limitation In the PTY, 



■5.7 U *ode 

s'htn aat U *ode eenverte "** In text llnee Into a etrl*a of 
two octal diojta equal to the PTY unit number. <L«ad|ng 
zeroe will oa Included.) All DEC SCRIPTe uee thla feature 
to loo I* the job under ppn 4,77700 through 4,7777? (I.e., 
4,777#). 



5,8 Initial valuea 

At the atart of each Data ever a SCRIPT, the following 
oarametere are aat uo. AM remaining qutntftTea are aat to 
zero. 



TYPE IN PATE 

TYPE OUT RATE 

ALLOWED RESPONSE TIME 

'REE TIME 

STAGGER TIME 

*E»EAT COUNT 

j HQOE ON, L MODE OFF 



•3 SEC/CMAR 
.1 SEC/CHA* 
10 S*C 
7 SEC 

H SEC/JOB 
1 PASS 



5,9 Same I 3 SCRIPT 

!l*SeMPLE ^C'I p T/PPC 25 JULY 1970 

LOGIN 

4,777* 

xxxx* 

IXIN 
DEL #.♦ 

MA F00.F4 

TYPE 1 
1 FORMAT (' HJ') 

EN? 

!L 



IDENTIFY SCRIPT 
START LOGIN 
USE 4#777?0* 

PASSWORD 
TELL OPERATOR 
CLEAR DIRECTORY 



TERMINATE 



?ZX$% 

IN 

rxECUTE POC 

*j08/B S TA "T LOGOUT 

jJoUT TELL OPERATOR 

<,0 0RE*A T ING INSTRUCTIONS 

1. Build i tlma»aharlna oyatom with tuffTelont Joba 
a*d Dttude-ttittyPMt Ona control job will bo 
naaded for itch 14 jobt following t*o SCRIPT, 

2. CPtiti an aooroorlate SCRIPT, 

3. Start tha SCRIPT orogft", 

4. It. #iti tyDt out tht «i*nt of tha ourrontly loadod 
SrRIPT, J? tht ■tomtht It 0haraMa» It will go to 

ttts 13, 

3. I* tht atomtnt Tt not iha'ablt, It aako H WMEfi£ TO 
L"A0 A SCRIPT?". Tyot tht doylea, Mlanama, 
tvttntlon, and dirtetory, If tPoumtntt art not 
suoaHtd, tnty *afault to DSKi,*c p 

6. TH t proortm will retoond wit* « v ArE LOADED XX 
LINES" a«d ratur* to monitor eom*a*d loyal, Tha 
*ama of tht Job win bt e*angad to tht ae'lot noma. 
If t*ara wara trrora It will am Tnttaaa If a 
SrRiRT la to ba loadad, Co bad* to ttao 5. 

7. If tht tortot It net go'no to b« thaPtd* tyoa 
"CONT" and oo to eteo Itf, 

0. Sava tha loadad SCRIPT with a SSAVE eommond, 
E*a*plat "SSAVE DSKirOOCC^". 

9, Start n cooToa of tha proOfa"* by tooolno In n Jobt 
a*d QlvMg tha eommand "RUN OSk TOO" or what avar 
Is naadad to load tha aavtd varalen from otap 8, 
T*a Inatruetlona In tha ramalnjn§ ataoa ahould ba 
foiiowad for taoh of tht n jobt. 

10, Tht program win now aak how many jobo ara to bo 
run, Entor tha numbar for aae* oontrol Job on |ta 
TTy, Tho maxmlmum numbar la 14 Jobo oor control 
Job. EacH objaot Job naada a PTy. 
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11. Should thoro bt too fow PTYa* than tho SCRIPT 
program w T l i raiaata a|| Ootttn to 'or and sok ovtp 
asaln how many Jobo ara to ba run* 

12. Th# flrat 1-14 jobs run by a olva" SCRIPT Job can 
bt monlterod on any dovlea, thlo !i uaoful fop 
debugging a now SCRIPT, Anowor tho quostlo* -watch 
h?w want JOBS?** appropr ittaly, A null raopenso 
(Juat <CR>> will raault in all Jobo balng 
menfterad. If you answor with a "u*bar mora than 
0i It will aoK "WHERE". Raooond with davlea* flit 
noma* o»tontlon, and dlractory, tho dafaulto ara 
OSKl.wCM, Should tho davlco bo uhaval labia* or tho 
fllo unantarabla» ah •r'or maogaga will aopagr on 
th§ talotyot and tho ouootlon wl|l bo asktd again. 

Should an orror occur on tht dov|eg wnlio funning, 
thf run win not bo ougognood. nowovar, oubaaouont 
monitoring will bo inhibltod. If mero than ono Job 
to bilng monltorodf oaoh ilna is or*ooodod oy tho 
proeoM numoor (01»14# daolmai), Excapt on a 
t»|otyoo monitor, aach lino "Ml bo Indantad 2*1 
ooaeoo, 

13. I' tha SCRIPT cat lo for faotar outout than tho 
doyfe* ean nandla* than tho SCRIPT Job will go Into 
I/O watt. Thlo will roouit I" vtry long do I ay 
tlmoo attploutad to tho SCRlpT orooram, Thlo 
condition mould bo avoided by changing tha SCRIPT 
DAPamatoPO, uoing a faatar davlea o f not monitoring 
at a I I. 

14. Tho program will now ask, "WHERE TO LOG RESPONSE 
TIMES?** Anowar with a davlea* ft la *a*a a aatanalon, 
a*d dlrootory. Argumonta not ouobllod will dofault 
to OSKi.RSP. A null 'aooonaa (Juat <CR>) *l I I 
raault in no raooonao* bo'ng loogodi 

If th* dovlco |o not ava|labia» or If tha fllo can 
not b« ontorod* go book to atop 14, 

Should a data orror oocur whilo running* tho run 

win orocood with sub'oouont responso logging 

Innlbltod. An arror mgsgagg will acoaar on tho 
toiatypo, 

15. SCRIPT aako "REPEAT COUNT « ", T yot a doelmal 
numoar, If zoro or null, tho ropoat count In tha 
SCRIPT will bo usod. 
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16. SCRIPT §•*• "DELAY FACTOR ■ ", Typp • dBBlmal 
nuwbaP. tnfa multlBlttt HI tht dalay tlmaa. If 1 
op null (Just <CR>># tht SCRIPT |B ta*an lltBPtllyi 
If 8» dalayt apt IgnoPtd, 

17. SCRIPT aafca "STaGGE* TIME • ", T yDi a daaf*a| 
numbaP, if nuli# tha valua In tht SCRIPT will ba 
u*al. M 0» no ataggaplng will tooly, If 
nen«ztpt# tht vtlut tyttd I" will bt takan (In 
stotndt), 

IS. SCRIPT tBkB •'SEE COMMENTS TQ OPERATOR? ", Tyot W 
op no. I' yta, til x SCRIPT Bommanda will bt tyotd 
tt orocttttd optfTxtd by tht ppoeoaa nuwbap (1*14) 
In dtelmtl within oaPtntnaala. 

19. I* SCRIPT Nat atstmbltd with tht d«bug twitch on 
(tht nepmal eatt)i It will aa* *QlBUG1 ", tntwtp 
yta op no. (f you tntwtp ytt, thtn SC*I*T will 
o^BPitt In DE9UC modti thlt will add to tht 
monltop fT|t (undtp monftopt with tht I matt *odt 
teanntp strvlot) tht JSb ttttut tteh tint It It 
netfctd to bt dlffOPtnt, Tht outtut w| || bt Tn tht 
fop* "C\nn\3" whtPt nn It tht hTgn epdaP alx bltt 
PttuP^td by tht JOBSTS UUO. Tntaa bltt a't tt 
foi lowti 

40 job nywbtP aaalgnad 

20 lob comoiotad logln t not atapttd 

looout 

10 TTY tt wtnltop Itvtl 

04 TTY output aval labia 

02 TTY Tn naad of Input to do anything 

01 eontpol e dafaatad 



20. SCRIPT aaks "WaTCH fOR ER*0*S?". Typt yta op no, 

If yta a ail pty output fop ail tht Jaba will ba 
monftoptd f oP "t" llnta, unlaaa tha SCRIPT haa 
pptllettd tPPOPt. all aueh llni will ba tyead on 
t*t ttittypt prtflxtd by tht ppo e taa numptp (1*14) 
In dtefmal within paptnthtaaa ana followad by two 
btnt, 

21. SCRIPT will aay "STARTING". Joba undtp eontpol of 
a otvtn oontpal bpoqpb^ will ba tttgotrtd ^ tha 
Mttpval apaolflad by tht oogPatop op In tha 
SCRIPT, \} multlolt SCRIPT Jopa apt punning, tht 
ustP tan ttaggtp tha I p timing by tndlng ttto 20 at 
t*t aoppooplatt timt of day. 
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22. w*tn tht laat jab Mndap a glvon $C*!PT ppogpa* hat 
flnlghadi tht maaaagg "*u J0&S gONC" will aoaaap 

o* the uoopg talatyaa and tha log 7 1 1 • and monitor 
Mia m|ii bo eleoed. Tha ppegpam will than exit. 

23. Should It ba naaaaaapy to tepwlngte » run# atop tha 
control program bv tyelng two <eontro| c> 
e*areetepe, To olaaa out tht leg file reenter tha 
p'oopft* by a paantap eommend, A mooeaoe "JOBS 
A?0It£0" win aaoaap on tho teletype, and all Jobg 
w|| | ba kjabbad. 

24. T*e FORTRAN proOPtm TOTAt eon ba uatd ta aum«aP|ia 
t*a rtaoonot lag file. It tgkaa Input fpom 
XIF9R0X.OAT and plaeaa a thPpt I latino on 
dir9R0a.OAT. 



SCRIPT 
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4,1 StiftBlt 9UIO0U8 

* SCRIPT 

MO SCRIPT LOAOED 

-JHERC TO L^AO A SCRIPT? SYSlOELALL 

1ELALL.SCP&SM LOADED 15 LINCS 

.SS OSKnELALL 
JOB SAVED 

tC 

'.RU OSKnELALL 

SCRIPT DCLALL.SCPX002 LOAOCO 

wOW MANY J?3S TO BE RUN? 14 

<ATCH HO- *ANY JOBS? 

-;MERE? DELI 

**ERE to LOG RESPONSE Tl*ES? OEL1 

REPEAT COU'T « 

"5ELAY factpr ■ 

STAGGER TI*E » 

SEE COMMENTS TO OPERATOR? Y 

?E0UG? N 

WATCH TOR ERRO R S? Y 

STARTING 

M) IN 

(2) IN 

(13) OUT 

(14) OUT 

ALL JOBS OCNE 
fXIT 

♦ C 



GET SCRIPT 
naM| Or SCRIPT 

Save so can share 
get sharablc copy 

MAX DUMBER 
50 AU 

USC 0SKI0EL1.WCH 
USE ^SKiOELl.RSP 
USE SCRIPT VALUE 
USE *C*IPT VALUE 
USE SCRIPT VALUE 
WATCH PROGRESS 
NOT USUALLY NEEOEO 
A G09Q IDEA 

J09 1 LOGGED JN 
J03 2 LOGGED I?. 

J09 13 LOGGED ?UT 
JO? 1« LOGGED CUT 
IT HAS FINISHED 



